home *** CD-ROM | disk | FTP | other *** search
Text File | 1992-12-28 | 56.7 KB | 1,300 lines |
-
-
- Documentation of DP Managing
- Copyright © 1992 David Scrève
- All Rights Reserved
- ---------------------------
- --------------------
-
-
- Document :
- Author : David Scrève
- Name : DP Managing.doc
- Software name : DP Managing
- Release : 3.0
- Revision : 7.1
- Date : December 28th 1992
- Size : 58013 bytes
-
- For any suggestion, complain contact me to the following address :
-
- M. Scrève David
- DP Managing Support
- 4, rue Gustave Flaubert
- 59115 Leers
- FRANCE
-
- Phone : 20.75.52.73 in province.
-
-
- Summary
- -------
-
-
- Content Line number
- ------- -----------
-
- Introduction..................................................0107
- Hardware requirement..........................................0180
- Installation..................................................0198
- User Documentation............................................0211
- I - General concept of DP Managing 3.0....................0214
- II - Running DP Managing..................................0234
- III - Menus Items.........................................0329
- A - Menu Project......................................0337
- 1 - Save the catalogue : Amiga + C...............0342
- 2 - Maintain : Amiga + M..........................0358
- 3 - About... : Amiga + A..........................0371
- 4 - Quit : Amiga + Q..............................0379
-
- B - Menu Program......................................0388
- 1 - Search : Amiga + J............................0394
-
- C - Menu Export.......................................0405
- 1 - News : Amiga + D..............................0427
- 2 - All : Amiga + T...............................0433
- 3 - Correspondances Code-categorie : Amiga + R....0439
-
- D - Menu Print........................................0451
- 1 - News : Amiga + N..............................0456
- 2 - All - Amiga + U...............................0464
- 3 - Statistics : Amiga + I........................0473
- 4 - Correpondances code-categorie : Amiga + G.....0481
- 5 - Some categories : Amiga + K...................0492
-
- E - Menu Modules......................................0500
- 1 - Single Consultation : Amiga + O...............0503
- 2 - Borrow Software : Amiga + E...................0509
- 3 - Add programs : Amiga + P......................0518
- 4 - Statistics : Amiga +S.........................0543
-
- F - Menu Protection...................................0553
- 1 - Protect The Database : Amiga + X..............0562
- 2 - UnProtect The database : Amiga + Y............0577
- 3 - Modify Password : Amiga + Z...................0584
-
- G - Menu Language.....................................0594
- 1 - Francais......................................0601
- 2 - English.......................................0606
-
- IV - description of the modules...........................0613
- A - Maintenance.......................................0617
- 1 - ERASE THE CATEGORIE...........................0631
- 2 - CREATE A CATEGORIE............................0640
- 3 - ERASE A MEMBER................................0647
- 4 - ADD A MEMBER..................................0658
- 5 - ERASE THE NEWS STATE..........................0666
- 6 - CHANGE THE CATEGORIE..........................0674
- 7 - DELETE THIS PROGRAM...........................0681
- 8 - ADD A FULL MEDIA..............................0688
- 9 - DELETE A MEDIA................................0710
- 10 - MODIFY THE PROGRAM...........................0719
- 11 - UPDATE FROM A FILE...........................0728
-
- B - Single Consultation...............................0738
- C - Borrowings........................................0760
- D - Add programs......................................0849
- E - Statistics........................................0932
-
- Conclusion....................................................0956
- DP Managing History...........................................0971
- Futur changes.................................................1170
- Bug report....................................................1188
- Greetings and Copyright.......................................1242
-
- ----------------------------------------------------------------------------
-
- Introduction
- ------------
- DP Managing was created in order to integrate in One Software all the
- tools required to manage a library of CD, cassette, video cassette,
- computer files or any information which can be organized in categorie
- and which atteched to a specific media.
- The complete package contains the following files on One disk :
-
- - Two files which contain the documentation in french and in english :
- DP Managing.francais and DP Managing.english
- - Two versions of DP Managing 3.0 : for 68000 and for 68020
- - The Two shared library Reqtools.library
- - The CLI Command XICON which is freely distributable
- - Two UpDate Files which is new for release 3.0 : it's for the users of
- an earlier release 2.xx : 3.0 UpDate.english and 3.0 UpDate.francais.
- They're in the directory UpDate.
- - A text file in french that explain how to use the 2.04 interface user and
- the requesters from reqtools.library : UserStyle.doc.
- - Two install scripts in french and in english
- - One Directory named DPMTransfers which contains the DPMTransfers program
- and 2 files : DPMTransfers.francais and DPMTransfers.english
- - A directory which contains 2 docfiles which explains the file format
- when you export the database : Exporte.francais and Exporte.english.
-
- DP Managing 3.0 is freely redistribuable for a non commercial use, but
- it's NOT FREELY USABLE. To use DP Managing, you MUST be a registred user.
- The question is : How can I become a registred user ?
- The answer will be : To be a registred, you just have to send me US 10$.
- with a postal order.
- Then you will become a registred user and you will received the last
- release of DP Managing.
- This payment permit me to continue to develop on this wonderful
- computer which is the Amiga.
- This software cannot be distributed in another form described above
- and no file must be on the same disk. No file I have created can be
- distributed without the complete package, except the file UserStyle.doc
- which can be distributed in all forms for non commercial use.
- When I speak aout "non commercial use", I think about a price which
- lower than US 3 $ per disk.
- DP Managing 3.0 cannot be load on any BBS or network, except if I
- receive all the benefits you receive with it.
-
-
- This package is a propriatary product of David Scrève and is
- Copyright © 1992 David Scrève. If you use DP Managing, it provided you
- agree with the following words :
-
- - You will not spread any uncomplete version of this package
- - You will not disassemble any executable file of this package
- - You will not modify any file created by DP Managing
- - David Scrève and Commodore cannot be responsible for any
- damage caused by DP Managing.
- - There is no warranty about the results, performance, and
- quality of DP managing.
- - Only the registered user (see above) is permitted to use
- DP Managing.
- - The registreed user is allowed to install DP Managing on
- many computer systems. But he is the only person who can
- use it.
- - The user can make many backup what he wants.
- - He can modify the package, if he does'nt spread this new
- package. If he makes a copy for another person, this copy
- must be the same as the present package.
- - The disk of this present package is named :
- DP Managing 3.0
-
-
-
-
- For more details about distribution, please read the doc file in french
- which is more valuable because my english is very bad.
-
-
- Hardware requirements
- ---------------------
- DP Managing 3.0 respects the Amiga "Look and Feel" style. So it needs
- some hardware elements which gives many other interesting features when
- you use other softwares.
- DP Managing 3.0 required a complete OS 2.04 or higher. The system
- software must be complete because the script installation uses some CLI
- commands.
- There is one version compiled especially for 68020 and the script
- installation can detect them. This version needs a MC 68020 or higher.
- This installation script allows you to install DP Managing on a different disk
- than the original disk, in order to create automatically a new database.
- I recommend you to make a backup of your original disk.
- DP Managing 3.0 can be load and run from a floppy disk but if you want
- to install it on another disk, you need 2 disk drives or an Hard drive.
- because of the size of files which are created, Hard drive is recommended.
-
-
- Installation
- ------------
- The install script is very simple and respect the "Look and feel" of
- DP Managing.
- To install DP Managing 3.0 you simply have to insert the floppy disk
- in drive DF0: after booting on your system disk 2.04. Now click once on
- the icon "Installation.english". Then press Shift and maintain it when
- clicking on the directory where you want to install DP Managing then on
- the icon "Installation.english".
- Attention, The script will created its own directory in the directory
- you have selected.
-
-
- User Documentation
- ------------------
-
- I - General Concept of DP Managing 3.0
- ----------------------------------
-
- DP Managing 2.x and higher is very different than earlier release
- (especially release 1.23 which was recently used by Ordileers).
- DP Managing 3.0 is very intuitive with its graphical interface. It tries
- to use each time the exclusive specifications of the OS 2.04 when
- possible : DP Managing is designed for the USER, not for the programmer.
- For example, if you have to enter differents texts in differents
- Gadgets, you can stay below your keyboard : you have just to hit the
- TAB key to go to another string gadget.
- The concept of DP Managing is organized around the module. A module
- is a complete interface user design to solve one main problem in managing
- a library of record. Each record (or title for a cassette) is called
- program. Each disk or cassette is called media. Now, there are 4 modules
- and a special 5th which concerns the maintenance of the database.
- In This text, we will first describe the items in the menus and then
- we will describe each module with more details.
-
-
- II - Running DP Managing
- -------------------
-
- Running DP Managing 3.0 is very simple : you have just to double click
- on its icon. Warning : you can't run DP Managing from the Shell. It
- needs some informations in the ToolsTypes of its icon. Here is a brief
- description :
-
-
- NOUVEAUTES = name of the file which contains the news in the database.
- EMPRUNTS = name of the file which contains the borrowings in the
- database.
- PROGRAMMES = name of the file which contains the programs in the database.
- SPECIAL = name of the file which contains the programs which are
- forbidden to under age people.
- CATEGORIE = name of the file which contains the differents categories
- of programs. Each categorie is represented by one file.
- DISQUE = name of the file which contain the differents disks
- Each media is represented by one file.
- ADHERENTS = Name of the directory which contains the differents members
- of the group. Each member is represented by one file.
- TEMPDIR = Name of the directory which contains the temporary files
- for the copy during managing the commands of the members.
- This directory is usually cleared after managing these
- commands.
- FIRSTDISK = Number of the first disk which will be created when you
- start a new database.
- LANGUAGE = contains the default language used starting on DP Managing.
- Actually, must be francais for french or english for
- english. By default, the software is french.
- COMMSIZE = Length of each comment atteched to each program ( = record).
- The default length is 65.
-
- DIRECTMEDIA = Yes or No. Must be Yes only if you manage computer files
- on floppy disk. This option allows to complete automatically
- the database with some routines of copy and with calculating
- the size of the disk : you have nothing to do.
- Must be No if you manage another types of data.
-
- PROTECT = Allows you to launch DP Managing in protected mode. if Yes
- The password you have defined (if you have protected the
- database) will be ask you to consult the database.
- if No, No password will be asked, but you will not access
- to any protection function and you will not access to a
- database which have protected before.
-
-
- ATTENTION : No file is directly accessible with a text editor : they are
- binary files and the format isn't so simple. No documentation will be
- given about the file format. For another information, contact me personnaly
- with a serious justification. For the children who would borrow software
- which are forbidden in changing their age, I said that calculating the age
- required more than 150 differents operations : Good Luck !
- Safety is at this price.
-
- By default, the below files are created during the first use and
- the drawers are created by the script installation. Frequently, the
- software doesn't start because of a bad description of the configuration
- in the ToolsTypes.
- The following lines describes the default configuration, after
- execution of the installation :
-
- NOUVEAUTES = fich_nouveautes
- EMPRUNTS = fich_emprunts
- PROGRAMMES = fich_programmes
- SPECIAL = fich_special
- CATEGORIES = categorie
- DISQUES = disque
- ADHERENTS = adherent
- TEMPDIR = tempdir
- FIRSTDISK = 201
- LANGUAGE = ENGLISH
- COMMSIZE = 65
- DIRECTMEDIA = No
- PROTECT = Yes
-
- ATTENTION :
- ---------
- If you destroy or modify manually one of these files, the database
- will be corrupted and maybe destroy.
-
- If you want to change the icon, the type of it must be PROJECT. For
- more information about it, please consult the Documentation of IconEd.
-
- When you have double-clicked on the icon, you will be welcomed by
- DP Managing and the software will indicate the configuration of your
- system. Then you can hit the [RETURN] key or click in the gadget to
- continue.
- If you have protected your database and you are in protected mode you
- will have to enter your password : you have 3 tries.
- If your database is protected but you are not in protected mode DP Managing
- will stop and will inform about the error.
-
-
-
- III - Menus Items
- -----------
-
- DP Managing 3.0 has just 7 menus without any submenus because
- I think that gadgets are more intuitives and faster than menus : the
- hot keys are visually shown and we haven't to learn them. Concequently,
- te program required OS 2.04.
-
- A - Menu Project
- ------------
-
- This menu groups the general functions as save, about, etc...
-
- 1 - Save the Catalogue : Amiga + C
- -------------------------------
-
- This option allow to save the catalogue of programs as a text
- file classified by categorie. The 2nd comment of each program
- is not written to have a text which has only 80 rows and also stay
- visuable by program such muchmore.
-
- When you select this option, a FileRequester will appear to choose
- you filename to save. If you select an existing file, DP Managing will
- request you to confirm erasing it.
- For the use of the FileRequester, please consult your OS 2.04 documentation,
- the book User Interface Style Guide edited by Addison Wesley, or the
- docfile UserStyle.doc, in french.
-
-
- 2 - Maintenance : Amiga + M
- -----------------------
-
- This option allow you to access to the functions of maintenance
- the database. Before using this module, I recommended to make a Backup
- of your files in the database.
-
- When you select this option, the window changes and you can see
- other Gadgets. But the menus are always accessibles and are the same
- as before. We will give more details about this module in the following
- part concerning the differents modules.
-
-
- 3 - About... : Amiga + A
- --------------------
-
- This option allows you to obtain informations about DP Managing
- and its authors. This options will be useful if you want to update your
- software or if you are a lucky person who belongs to developement team.
-
-
- 4 - Quit : Amiga + Q
- ----------------
-
- This option allows you to quit DP Managing and free 220 Kilo-Bytes
- of memory. To Quit DP Managing you can close the window too.
- Before quiting, DP Managing asks you to confirm your decision.
-
-
-
- B - Menu Program
- ------------
-
- This menu gives you functions to perform actions on One program
- in the database. Now, there is only one option.
-
- 1 - Search : Amiga + J
- ------------------
-
- This option allow you to search a program in the complete
- database. To perform this action, a requester will open : you will have
- to give the elements you know : name, categorie, media. If you confirm,
- DP Managing will search this program in the database and will give you
- the name, the categorie and the media of the program if it has found it.
- If it hasn't found the program, DP managing will say it to you.
-
-
- C - Menu Export
- -----------
-
- This menu gives you functions to export the database into another
- file format. This format was first created for the Group Ordileers which
- use it in his server Minitel (french national terminals network). This
- file format is described in the file Exporte.english, in the directory
- Exporte. For more informations about it, you can display the file generated
- with a texte reader or contact Ordileers to :
-
- Ordileers
- 9 bis rue du général de Gaulle
- 59115 Leers
- FRANCE
-
- You can call them on their server from monday to friday at the
- following number : 20.82.95.36 in France.
- For any consultation, you need a Minitel.
- During the week end, you will have to talk french to a person and not
- to a server : Then, the minitel is not required.
-
-
- 1 - News : Amiga + D
- ----------------
-
- This option allows you to export only the news.
-
-
- 2 - Tout : Amiga + T
- ----------------
-
- This option allows you to export the complete database.
-
-
- 3 - Correspondances Code-catégorie : Amiga + R
- -----------------------------------------
-
- In the file format, each categorie is represented by a 2
- caracters code.
- This option allows you to generate a text file where the
- correspondances between the code and the categorie are easily
- readable.
-
-
-
-
- D - Menu Print
- ----------
-
- This menu groups the functions to make output to the printer.
-
- 1- News : Amiga + N
- ----------------
-
- This option allows you to print the categories where are some
- news. Before printing DP Managing will request you to confirm : to
- confirm, click on gadget [OK] and to cancel, click on [CANCEL].
-
-
- 2 - All : Amiga + U
- ----------------
-
- This option is similare to the News option. But all the database
- will be printed out. Personnaly, I recommended to print out One categorie
- per page. This will permit to you to easily update your catalogue in
- just printing the categorie which have some news.
-
-
- 3 - Statistics : Amiga + I
- ------------------------
-
- This option allows you to print statistical datas about the
- borrowings of programs. If you need others statistical datas, send me
- a letter and It will change.
-
-
- 4 - Correspondances code-catégorie : Amiga + G
- ------------------------------------------
-
- In the file format, each categorie is represented by a 2
- caracters code.
- This option allows you to print out a paper where the
- correspondances between the code and the categorie are easily
- readable.
-
-
-
- 5 - Some catégories : Amiga + K
- ---------------------------
-
- This option allow you to print some categorie and not the complete
- database. A ListView will appear and you will have to choice the categorie
- you want to print. To perform printing you have just to click on the [OK]
- button. This sequence will go while you don't click on the [CANCEL] button.
-
- E - Menu Modules
- ------------
-
- 1 - Single Consultation : Amiga + O
- -------------------------------
-
- This option allows you to go to the consultation module. This
- is the module by default when you start DP Managing.
-
- 2 - Borrowings : Amiga + E
- ----------------------
-
- This option allow you to go to the module which manages the
- members's Commands of programs. You have just to enter the commands
- with the mouse and DP Managing will update the statistical datas.
- If you have select Yes in DIRECTMEDIA, it will request the right
- disks to insert and will automatically copy the files on the disks.
-
- 3 - Adding programs : Amiga + P
- ---------------------------
-
- This option allow you to go to the module which complete the
- bank of programs and the database.
- If you have written Yes in DIRECTMEDIA, you can just add programs which
- are in a Single File form.
- For the complete disks, you must go to the module maintenance.
- I recommended you crunch ypur software with lha. The .lzh is recommended
- but not needed.
-
- How to use LHA :
- --------------
-
- To crunch just one file, type :
- lha -2 a <filename>.lzh <filename>
-
- To compress a complete directory, type :
- lha -r -2 a <filename>.lzh <directory name>/#?
-
-
- I recommended you includes the icons of the directories in the
- archive.
-
-
- 4 - Statistics : Amiga +S
- ---------------------
-
- this option allow you to access to the module of statistics.
- You can just see the statistical datas and there is no update function
- because the update is done by the module named "adding programs".
-
-
-
-
- F - Menu Protection
- ---------------
-
- This menu which appeared with the release 3.0, gives a
- interesting answers to people who want to protect their database.
- Warning, this menu is accessible if you have set the PROTECTED
- toolstypes to Yes.
-
-
- 1 - Protect the database : Amiga + X
- --------------------------------
-
- This option permits you to protect a database which was
- not protected before (as default for a new database).
- A requester will appear and you will have to enter a password
- and an integer number. To confirm this code, click on the [OK] button.
- Then, you will have to confirm your code.
- You should write this code somewhere because without it, it's
- impossible to read again the database.
- Such protected database is now unreadable if you don't start
- DP Managing in protected mode, and the two codes are required to read
- it again in protected mode.
-
-
- 2 - UnProtect the database : Amiga + Y
- ----------------------------------
- This option allows you to unprotect a database which was
- protected before.
- The database will be now readable in any mode of protection, and
- no code will be required to start DP Managing in protected mode.
-
- 3 - Modify Password : Amiga + Z
- ---------------------------
-
- This allows you to modify the two codes of the protection of
- a database which was protected. A requester will appear and you will
- just have to enter you new codes. To confirm these codes, just click
- on the [OK] button.
-
-
-
- G - Menu Language
- -------------
-
- This option is made to allow the user to change the language of
- DP Managing. Actually, you have choice between french an english.
-
-
- 1 - Francais : Amiga + F
- --------------------
-
- This option change DP managing's language into french.
-
- 2 - English : Amiga + H
- -------------------
-
- This option change DP managing's language into english.
-
-
-
- IV - Description of the modules
- --------------------------
-
-
- A - Maintenance
- -----------
-
- First, you can see two big Listviews which contain, for the first,
- the list of the available categories, and the list of the programs which
- belong to the selected categorie, for the second. The complete will
- organized around thes two gadgets which come from the GadTools.library.
- below each listview you can see one string gadget which shows the
- element selected. If you try to enter text in these gadget, there is no
- effect.
- We will new describe the functions which are accessibled by differents
- buttons.
-
-
- 1 - ERASE THE CATEGORIE
- -------------------
-
- This button permits to erase the categorie selected.
- Warning : All the programs which belong to this categorie will be
- erased from the database. The action will be perform after confirming
- in a requester.
-
-
- 2 - CREATE A CATEGORIE
- ------------------
-
- This button simply allows you to create a new categorie of programs.
- You simply have to give its name and its code.
-
-
- 3 - ERASE A MEMBER
- --------------
-
- This button allow you to erase a member. A list of the existing
- members will appear on your screen and you will have to choose one of
- them. You could cancel this action in clicking on the [CANCEL] Gadget or
- not confirming the action after. Warning, this action does not erase
- the number of borrowings for each categorie in the statistical datas.
- You could'nt just access to the details of the borrowings of this member.
-
-
- 4 - ADD A MEMBER
- ------------
-
- This button allow you to create a new member in the database.
- His name, surname and day of birth will be required. The day of birth
- must be in the same form : dd-mm-yy
-
-
- 5 - ERASE THE NEWS STATE
- --------------------
-
- This button allow you to delete the quality of new in the New
- programs : The new programs will change into old programs. This allows you
- to enter other new programs.
-
-
- 6 - CHANGE THE CATEGORIE
- --------------------
-
- This button allows you to move the selected program to another
- categorie. You will have to select the TO categorie and to confirm the
- movement.
-
- 7 - DELETE THIS PROGRAM
- -------------------
-
- This button allows you to erase a program from the database. Warning
- the number of borrowings of this programs is erased too.
-
-
- 8 - ADD A FULL MEDIA
- ----------------
-
- ********************************************************
- * OPTION UNAVAILABLE IF YOU HAVE SET DIRECTMEDIA TO NO *
- ********************************************************
-
- This button allows you to add a complete media in the database.
- This function is useful when you want add programs such Megademos which
- must be distributed on a full disk. If the program is composed with more
- one disk, you must repeat this operation for each disk.
- To do this add, you need the name of the program, the 2nd comment
- needed and the 1st comment. If this program is forbidden for under age
- people, you can select this. If you confirm this add, you will have to
- insert a formatted and blank disk.
- Warning : This blank disk must be DOS and not NDOS. If this disk is NDOS
- or cannot be renamed, insert another blank disk : DP Managing will rename
- this disk and give the new name to you. You will just have to write
- the number of the media on the new disk.
-
-
-
- 9 - DELETE A MEDIA
- --------------
-
- This button is similar than ERASE A CATEGORIE. You have to choose
- a media in a listview and if you confirm, DP Managing erases all the
- selected media and the programs which belong to it. This function is
- useful if you have media which have been being destroyed.
-
-
- 10 - MODIFY THE PROGRAM
- ------------------
-
- This button allows you to change the 1st or the 2nd comment
- attached to a program. A Requester will appear and you will just have to
- modify what you want. The Empty fields will be refused by DP Managing.
-
-
-
- 11 - UPDATE FROM A FILE
- ------------------
- This option allow you to update you statistical datas from
- an external file which was generated by another computer when it have
- managed some borrowings (cf Borrowings module). A FileRequester will
- appear to choose the file to load and the update will be done
- automatically. For more details, see the chapter about the Borrowings
- module.
-
-
- B - Single Consultation
- -------------------
-
- This module was designed to scan the complete database in a fully
- interactive way.
- You can see four lists called ListViews. Under each listview you can
- see a string gadget which shows what you have selected.
- If you select one of the available categories, the list of programs change
- with the list of the programs which belong to the selected categorie.
- The second program will be automaticaly selected and the media of this
- program will be too selected : you can see the programs which belong in
- the same media than the selected program.
- This sequence could be done starting with selecting the media and the
- categorie of the program would be automaticaly selected.
- You can now select one program of the two lists and the others lists
- will be automaticaly updated.
- Under these listview, you can read other informations about the selected
- program : size in Bytes, comment, 2nd comment, number of borrowings
- and if the program is new or not and if it's forbidden for under age.
-
-
-
- C - Borrowings
- ----------
-
- This module will help you to manage the commands of programs from
- the members.
- Warning, this module creates 2 temporary files you must delete before
- starting anything else in this module. Usually, they are automaticaly
- deleted, but they could exist if DP Managing has already been stopped by
- any problem in your system (gourou meditation, DP Managing's Bug
- (what ? impossible !) etc...).
- These 2 files are located in DP Managing's directory and are named :
-
- DP_MANAGING_TEMPFILE
-
- DpManaging_TempFile
-
-
- If they aren't deleted, you can have many problem during managing
- the commands.
- I recommended too to clean the temporary directory (default name : tempdir)
- Usually this directory is automaticaly cleaned. If this directory isn't
- empty, the unit could be full during the managing.
-
- In the module, you can see 3 ListViews : One for the medias, one for the
- list of the programs contained in the selected media, and one for the list
- of the members. You can't access to the menus because the menus options
- could conflict with the module. The only way to change the current module
- is to click on the [CANCEL] button. If you close the window, you quit
- DP Managing.
-
- To enter a commands, execute the follwing actions, in order :
-
- 1 - Select a member
- 2 - Sélect the media of the first program of the command
- 3 - Sélect the program
- 4 - Click on the [CONFIRM BORROWING] button
- 5 - Return to the action 2 until you have enter the complete command
- (by default, one commands contains 5 programs)
-
- To delete a program from a command :
-
- 1 - Sélecta member
- 2 - Sélect the program to delete
- 3 - Click on the [DELETE] button
-
-
- You can also simply manage all the member's commands in clicking on their
- name. If you click on a borrowed program, you could have its size in
- Bytes. The number of media required is given too. By default, the size of
- one media is 830000 (which is the size of one Amiga disk : just for
- compatibility when you switch DIRECTMEDIA to Yes), and one command needs
- one media.
- When you have entered all the commands, you must decided how the
- statistical datas will be updated. To perform this action, you have
- 2 buttons which allow you to update to datas on an external file or
- directly in the database. If you manage the commands with only one Amiga
- you should choose update the Database directly. If you manage the commands
- on differents computers, it's very useful to have the statistical datas on
- only one system : So you should select an update on an external file.
- If you choose an external update, the module will generate an external
- file which name will be given at the end of managing the commands. The
- statistical data will not be directly updated. To finally update the
- statistical datas on your main Amiga, you have to use the maintenance
- module and the option UPDATE FROM A FILE. Then the statisticals will
- be really updated. Your main Amiga contains the real statisticals
- data and it must update directly the statistical data, because it is the
- computer which contains the statistics.
-
- When you have choose your update mode, you have just to click on the
- [PERFORM ALL THE COMMANDS] button.
- If you have switch DIRECTMEDIA to No, DP Managing will just update
- the statistical datas.
- If you have switch DIRECTMEDIA to Yes, DP managing 3.0 will ask you
- for the differents disks of the bank of programs it needs and will copy
- the programs commanded in the temporary directory.
- Then, it will ask you for the members disks and manage the commands.
- During this process, the gadgets are unacccessible. When this process is
- ended, DP Managing returns to the Single Consultation module.
-
-
- If you have click on the [CANCEL] button before starting managing the
- borrowing, you return to the Single Consultation Module.
-
-
- DP Managing has powered functions to manage computer file and permits
- to have easily statistical datas about borrowings for any media.
-
-
-
- D - Add programs
- ------------
-
-
- This module has been written to complete the banks of programs and
- the database automatically.
- There are 2 cases : if you have switch DIRECTMEDIA to Yes or No in
- the Icon file.
-
- ** 1ST case : DIRECTMEDIA = No
- ----------------------------
- The processus is simpler than the other.
-
- You will see many string gadgets to fill in : program name, comment,
- 2nd comment, size and if the program is forbidden for under age people.
- You will fill in these Gadgets, in writing an interger value for
- the size. You will confirm in clicking on [CONFIRM THE ADD] and the add
- will be done automatically.
- If you want to empty all the field an trying again, just click on
- [CANCEL THIS ADD]. If youy want to stop all the adds, click on
- [CANCEL ALL].
- If you have confirmed this add, a list will appear : you will have to
- choose the categorie of your new program. You can cancel in clicking
- on the [CANCEL] button.
- If you click on the [OK] button, you will have to choose the media
- of your new program. If you click on the [NEW] button, you will create a
- new media. It allows you to create a new cassette, Audio CD, etc...if
- all the existing in the database are full.
- For managing this add, just click on the [OK] button.
- This procedure will restart until you click on the [CANCEL ALL] button.
-
-
-
- ** 2ND case : DIRECTMEDIA = Yes
- ----------------------------
- You will complete a database made with computer files on floppy disks.
- To perform this action, each program MUST be a Single File.
- I recommended you compress your software in one file. The .lzh is
- recommended, but not needed, and I recommended the software lha to compact
- your software. All your files must be in the same directory.
- When you start this module, a FileRequester appear and ask you to choose
- the directory where your new softwares are.
-
-
- WARNING : This directory musn't contain other file than the new programs.
- If there are other files, these files will be add to the
- library as normal programs. You can cancel adding this file
- but it isn't recommended.
- When a file has been added to the database, it's automatically
- deleted from the directory : Check if you want to delete it
- before adding this program.
-
-
- To easily work, prepare a efficient number of blank and formatted disks
- to copy the programs in the database : DP managing will ask you for them
- when it will need them and will give you their number. Each disk will
- be renamed by his number. Don't rename these disks if you doesn't want
- to have any problem.
-
- When you have choose the directory, DP Managing will scan all the files
- contained in and will ask you for differents informations about these.
-
- First, differents gadgets appear concerning the comment, the 2nd
- comment and the fact that this program is forbidden for under age people
- or not. You just have to complete these gadgets. To perform this add you
- just have to click on the CONFIRM THE ADD] button. You can cancel this add
- or cancel all the adds with the others buttons.
-
- Then, you must enter the categorie of this new program. The list of
- the categories will appear and you can choose on of them. If you want
- cancel adding this program, click on the [CANCEL] button.
- If you have choosen to add this program, click on the [OK] button.
-
- If you confirm this add, DP Managing 3.0 will ask you for a disk in
- the bank or for a new blank and formatted disk to copy the program in
- the library. The FROM file will be DELETED.
-
- This procedure will repeat until there is no program in the selected
- directory. Then DP Managing 3.0 will be return to the Single
- Consultation module.
-
-
-
- E - Statistics
- ----------
-
- This module gives you statistical informations about the borrowings
- per categorie, per member and for each program, in an interactive way.
- First, we can see 2 parts in the window :
-
-
- ** In the left side : 1 column which contain 2 ListViews containing
- the list of the categories and the list of the selected categorie.
- We can see below each ListView the numbers of borrowings in each
- categorie and for each program.
-
-
- ** In the right side : This side concerns the informations for
- each member. We can see the list of the members and on its right,
- the list of the programs he has already borrowed. We can select a program,
- but it's no effect now : It's for the future.
- Below, we can get others informations about the surname, age and the
- number of commands and the number of programs borrowed.
-
-
-
-
- Conclusion
- ----------
-
- This is the second release in English of DP Managing. I know my English
- is bad, but I hope to be understand. I think I have explain all the
- features of DP Managing 3.0 ? As you can see, DP Managing offers many
- features and many will be added in the futures, as it has made in the
- past since the 1.23 release. But if you want many change, you must
- complain yourself to me. And don't be afraid, I like being criticizing
- in french, english or german.
-
-
- ----------------------------------------------------------------------------
- ----------------------------------------------------------------------------
-
- Release History :
-
- Release 1.23 : August 1991 20th
- First operationnal release of DP Managing which was not
- named with this named. Written in GFA Base 3.01, it worked
- only in memory with text files. The database was limited
- to 1500 programs and 30 categories and only 50 programs
- per categorie. This software needed 2 Meg of free RAM
- and should ahve to support many bugs of GFA Basic 3.01
-
-
- Release 2.0 (Revision 4.52) : August 1992 11th
- Second release available in the public domain : Fully
- rewritten in SAS/C 5.10b and rethough for the OS 2.04.
- DP Managing represents 8913 lines of C for the code,
- and more than 10000 lines of intermediat code. I have
- work more than 350 hours for 1,5 month. Greetings to
- Franck Gédo for his help during debugging, his advices
- and for correcting this text.
- DP Managing is now just limited by the disk capacity
- concerning the size of the database. It can now manage
- the commands of the members completely (copying and updating
- the statistical datas) and update the library of programs.
-
- Release 2.1 (Revision 5.01) : August 1992 17th
- Third release, unavailable for the public, deleted from
- my archives.
- - Bug when computing the age of the people fixed (the age was
- increase of 1 year)
- - Bug when deleting a disk : the disk was effectively deleted on
- the disk, but not in memory : fixed
- - Change in the Text of the option "About..."
- - As we expect, we can now print just some categories (last option
- in the menu Print)
- - The structure of the code was Release for doing easier change
- in the software : The code is the same for all the releases
- (demo and other)
- - Bug whne printing categorie where there is no program to print : the
- header is now not printed
- - The area for reading is biggest in the Single Consultation
- module.
- - Bugs in the documentation : fixed
- - The demo and the complete release are in the same executable.
- - All the requesters support Hot keys with [RETURN] for OK and
- [ESC] for CANCEL
- - The wait pointer is now animated and appears when it's really
- needed.
- - Most Gadgets supports an Hot key shown by an Underscore of
- the hot letter.
- - The number of disks needed for managing one commands is more
- real than before.
-
- Release 2.11, Revision 5.21 : August 1992 21th
- Third version available for the public. This release is more usable
- than release 2.1 and has new interesting features which permit
- to use DP Managing with only keyboard or only mouse with the same
- possibilities :
-
- - Many requester appears in the DP Managing screen and not in the
- Workbench Screen : I use the Reqtools.library less than before,
- because it react at too many random.
- - When you enter a new member, categorie or programmes, each
- gadget has its own Hot key.
- - When we erase a disk or a member, the text doesn't speak about
- categorie : bug fixed
- - When we add new programs, the place where we write is bigger
- - The pointer is not animated now : the reqtools.library. This
- was not correctly explain in the reqtools.library documentation
- - Most of the string gadgets support an HotKey now
- - When we must select an disk or a member to delete, a requester
- inform us if we haven't select anything.
- - Some debug code has been deleted from the 2.1 source code.
-
- Revision 5.22 : August 1992 22th :
- This revision has been distributed to few people. This
- revision replaces the before which is unavailable now.
-
- - Now the Borrowings module support the HotKeys
- - The screen title has been corrected to be the same as the other
- modules.
-
- Revision 5.23 : August 1992 28th
- This revision replace the before.
- Some has been fixed and now DP Managing give the unit of memory
- to show the free memory when starting.
-
- Revision 5.30 : August 1992 29th
- This revision replace the before :
- Now, the requesters appearing when we add new programs
- appears only when they are needed : there are just 2 requesters
- to informs us that the 2 mains actions are succesful : they
- appears only when there is a problem or appears when ther is
- no problem, but support HotKey in this case.
-
- Revision 5.31 : September 1992 5th
- Thisrelease replace the before :
- - The routine which save the catalogue had been rewritten
- for the release 2.1 and save the configuration too, which cause
- that the text xas unreadable from muchmore : Bug fixed
- - The date of the last touch of each release appears now
- in the option "About..."
- About.
- - The summary had been corrected : the line numbers were
- false.
-
- Release 2.2 : Revision 6.2 : September 1992 12th
- New release of DP managing for ATACOM'92 :
- - Support 2 languages : DP Managing speaks now english
- - Add a new ToolsType for supporting the new features of 2
- languages.
- - Support NTSC monitors (not tested)
- - Allow to modify the comment and the configuration of a
- program.
- - Can research a program in the complete database
- - Documentation partially translated in English
- - The files in the temporary directory are now really deleted
- when all the commands has been managed
- - DP Managing allow now the user to manage the commands on
- different computers and to backup the statistical datas on
- only one computer.
-
- Release 2.21 : Revision 6.5 : September 1992 14th :
- debugged Version of the revision 6.2 :
- - When we change the language in the module of maintenance, the
- gourou doesn't make now any meditation.
- - The complete documentation is translated in english, even the
- other text and the script installation.
- - The English messages are not written above others gadgets in the
- module statistics
-
- Revision 6.51: September 1992 16th :
- - The size of the programs given in the Single Consultation module
- is now differents than -1 : The consultation function which
- has been rewritten for release 2.2 was corrupted. This bug is
- now fixed with the help from Jérôme Torchy who has found this
- bug, I have solve it.
-
- Revision 6.52: September 1992 19th :
- - The installation script doesn't crash now when we try to
- install DP Managing in a directory where it was already
- present (earlier or same revision) and when the 68030/882 chips
- had been detected.
- - Updating the statiscal data from an external file is now
- fully runnable : A bug has been fixed : when we wanted to
- select the file to load, the FileRequester appears after
- each click on the [OK] button and refused : bug destroyed.
- - I have found a bug when starting DP Managing on certain
- A2000 : On the compteur of Jean-Michel Forgeas and Christophe
- Legrand, DP Managing crashes at start and the Gourou comes to
- do his loved Meditation. I'm searching for more details about
- this problems and good bug reports. Please help me.
- (I think I could be the startup code from the SAS/C C compiler)
-
- Release 3.0 : Revision 7.0 : December 25th 1992 :
- That's my Christmas present to the Amiga community.
- DP Managing is more than a single new release, this is a new
- concept and new Amiga users are now concerned. Now, DP Managing
- is shareware because of price of SAS/C developement Kit,
- Amiga ROM Kernal manual, and many others documentation, mails
- which are concerned by DP Managing developement : Now the
- will think to me when he will sleep and I will compiled all
- over the night !! (the '030 isn't too faster)
- What's new is this release :
- - The Borrowings module is now fully debugged, just for
- Jean-Francois Pau
- - DP Managing was compiled under SAS/C Release 6.0
- - One bug which corrupt the system when DP Managing could
- found a library has been destroyed.
- - new, DP Managing supports a size until 400 caraters for
- the comment of each program : Thanks to Stéphane Anquetil.
- - DP Managing can works on every data which can be stored
- in a list : it isn't limited to computer files : Thanks to
- Stéphane Anquetil again.
- - The protection system has been fully rewritten : each
- user can defined its own code.
- - A new file format has been rewritten with a tool to
- convert old files from release 2.xx : DPMTransfers, fully
- under workbench.
- - The Add module has been rewritten in order to support
- anythings else than computer files.
- - All the listes are now sorted in aphabetical order : an
- important problem has disappeared.
- - DP Managing has now many new features to manage the text
- which can helps it to integrate easily an ARexx port.
- - The export files are now described in a docfile, in
- french and in english.
-
- Revision 7.1 : December 28th 1992 :
- I have found two major bugs and corrected a word in french.
- - The copy routine had a VERY BIG bug : I don't know how
- it could go before.
- - The borrowings module doesn't generate an empty file now,
- as before.
- - The word "configuration" has replaced by "comment 2".
- This was made because a tape recorder doesn't need any
- configuration, but it can need some other comment.
-
- ----------------------------------------------------------------------------
-
- Futur changes in the Software :
-
- - Add an ARexx port
-
- - Add many features when printing the statistical datas
-
- - Correct the errors and my english in the documentation, and try to
- be more understanding.
-
- - Add new features when encrypt the password.
-
- - DP Managing will print the current program in the Consultation module
- into the ClipBoard : it allows the cut and paste function in your
- favorite text editor.
-
- - A new module will be created : it will allow to know if any program
- is available or borrowed : it's useful for programs which can be copied
- (for example : books, etc...)
-
- ----------------------------------------------------------------------------
- ----------------------------------------------------------------------------
-
- For any information, contact me to the address written below, or for
- any bug report. For the bug report, please write it as Commodore says :
-
- 1) Hardware used
- -------------
-
- * Type of Amiga
-
- * Capacity and type of memory (slow, Chip, Fast, autoconfig)
-
- * Custom Chip : name, revision (R3 for Denise ECS 8373), referen-
- -ce, ECS or not, PAL/NTSC
- * external hardware used for saving : Hard disk, floppy drive
- with total capicity and free space.
-
- * Other hardware which can change any system vector or forbidden
- thing (Freezer card, etc...)
-
- * Hardware extension such accelerator card.
-
-
- 2) Software Environnement
- ----------------------
-
- * Version of your system software (Kickstart et WorkBench) written
- such 3X.XXX and not 2.XX
-
- * Version of all your library in the directory libs:
-
- * Version of all your handlers and devices
-
- * Reference of all your softwares used in the same time (antivirus,
- mouse accelerator, replacing ROM in RAM 32 Bits, etc)
-
-
- 3) Analysing the problem
- ---------------------
-
- * Describe the problem with many details
-
- * Describe the differents action needed to obtain this problem
-
- * Consequences created by this problème (database corrupted,
- Gourou meditation, etc...)
-
-
- ----------------------------------------------------------------------------
- ----------------------------------------------------------------------------
-
-
- All the trademark written in this text are trademark.
-
-
- Thanks to :
- - Jay Miner for the Amiga
- - Bell Laboratorie for the C language
- - SAS Lattice for his C compiler
- - All the Ingenieer of Commodore-Amiga for the OS 2.04
- - Franck Gédo for the design, correcting this text and
- for the tests in the first revision of DP Managing 2.0.
- - Nico François for the reqtools.library used in this software.
- - Ordileers for his ideas, and interesting advises.
- - Jan van den Baard for GadToolsBox
- - Jérôme Torchy for having found the bug in revision 6.5 in
- Single Consultation module.
- - Jean-Francois Pau for having tested DP Managing in a real
- environnement.
- - Stéphane Anquetil and all the team of ATACOM for their
- suggestion.
- - Thomas Jalmain for his small works about the protection
- of datas (very small, but useful).
- - Jean-Michel Forgeas for his powerful text editor : I'm still
- searching faster in all computer, but I have not found. I'm
- waiting for the commercial version !!!
-
- No Thanks to : Commodore France for their refuse giving any documentation
- about OS 3.0 : to develop freely distributable software,
- it costs US 180 $ : Their don't encourage Public domain
- Software.
-
- The file reqtools.library ist Copyright © Nico François.
-
-
-
- ********************************************
- * DP Managing is © 1991-1992 Scrève David. *
- ********************************************
-
-
- DP Managing 3.0 is freely redistribuable, but NOT FREELY USABLE
- DP Managing 3.0 cannot be used in any way without my written agreement.
- I could'nt accept that someone earn money without my written agreement and
- if I don't receive all the benefits.
-
- All types of contribution with documentation, help or money are welcomed
- to help me to give to Amiga the notoriety he should have.
-
- ****************************************************************************
- ****************************************************************************
-
- Have a FUN with DP Managing 3.0 and don't forget :
-
- //
- ***************** Only \X/Amiga Makes It Possible ***********************
-
-
- ****************************************************************************
- ****************************************************************************
-